home *** CD-ROM | disk | FTP | other *** search
/ Atari Forever 4 / Atari Forever 4.zip / Atari Forever 4.iso / SERIE_AI / AI_031 / GENFIX.ZIP / GENFIX.TXT < prev   
Text File  |  1996-03-12  |  14KB  |  349 lines
  1.                           Generic STOS Fixer v1.00
  2.                           ========================
  3.  
  4.  
  5. Contents:
  6. ---------
  7.  
  8.     + Introduction.
  9.     + Usage instructions.
  10.        - drag & drop.
  11.        - command line.
  12.        - GEM based.
  13.     + Limitiations.
  14.     + Falcon Compatibility.
  15.     + Known Bugs/problems.
  16.     + Legal stuff.
  17.     + Credits.
  18.     + Contact info.
  19.     + Advertisements.
  20.  
  21.  
  22.  
  23.  
  24. Introduction:
  25. -------------
  26.  
  27. When STOS was  written,  it was  decided that  to improve  the speed  of  some
  28. commands  the addresses  of certain  routines in  the Operating  System  could
  29. be stored  in a  table at the beginning of the program to  prevent them having
  30. to be  looked up each  time it  is run.  However,  as these  addresses  change
  31. with  every  new  release  of  the  Operating  System STOS  had to be updated.
  32. While  Mandarin  still supported  STOS this  was OK,  as they  simply released
  33. a new  version  with  the  updated  table,  along with any bug fixes. However,
  34. as  Mandarin  no  longer  support  STOS  there have  been no official releases
  35. containing  new  tables  for  any version  of TOS  greater  than  TOS 1.62. To
  36. get  around this  problem,  any compiled  STOS program  can be  'fixed'  which
  37. simply  means  replacing the  table with a  suitable table for  the OS version
  38. - this is essentially what Mandarin would have done.
  39.  
  40. At this  time,  there are  two STOS fixers available (with numorous versions),
  41. the latest  version of each  is called  STOS Fix 3. However,  neither of these
  42. is perfect.  One, by  Robert  Quezada,  only fixes  the STOS  program for  the
  43. CURRENT version of  TOS, thus  making it  necessary for  the end  user of  the
  44. program, not the author to fix the program - this seems rather unprofessional.
  45. The  other  (so  I am  told - I  don't have  it), from  Goodmans PDL, is  only
  46. available  from Goodmans, and  is not available via FTP on the internet. Also,
  47. it places an advert for Goodmans PDL on any STOS program fixed with it -again,
  48. not very professional.
  49.  
  50. So, the solution is the Generic STOS Fixer. This fixes a  STOS program for any
  51. 10 versions of TOS  (unfortunately,  at this time  there are 14  versions, not
  52. including  MagiC).  Which  versions  are used is determined by the DEFxxxx.DAT
  53. files in  the same  directory as  GENFIX.PRG,  where xxxx  is the  TOS version
  54. number, and also the settings if you have used the GEM interface.
  55.  
  56. Supplied with this program are DEFxxxx.DAT files for all existing TOS versions
  57. from TOS 1.0 through to 4.92 except TOS 3.05 and 3.06 (if anyone has a TT, and
  58. has a joystick, please get in touch - I would  like to obtain these versions.)
  59. Which files are ommitted is up to the person fixing  the program (I  recommend
  60. authors do this before releasing software..) but I would recommend leaving out
  61. TOS 1.1, as  this is  very rare  (I didn't  even know 1.1  existed!), and also 
  62. TOS 2.05 and 3.05 as these versions have been superceeded by updated versions.
  63. TOS 4.92 is only available on disk, so this can be safely left out, as someone
  64. with this version will also have another 4.0x version.
  65.  
  66. One interesting point is that if a STOS program is fixed for TOS 2.06, then it
  67. appears to work under GEMulator - the ST emulator  for the PC made by BraSoft.
  68. I am currently in the process  of trying to  establish if STOS  will run under
  69. STonX - the ST emulator for Unix machines (eg Linux, SGI's, Sun's etc.)  After
  70. the success under GEMulator, I suspect that it will work.
  71.  
  72. To make  STOS itself run,  it is necessary to fix the  BASIC206.PRG file. This
  73. can be  done in exactly  the same way as  any  other STOS  program.  The  only
  74. exception is that it appears that this can only be fixed for 8 OS versions.
  75.  
  76.  
  77.  
  78. Usage instructions:
  79. -------------------
  80.  
  81. This program will work in a number of ways -
  82.  
  83. 1) Drag a file to the program  icon (TOS 2.06 or  greater required). This will
  84.    start up the fixer, which will attempt  to fix the program. The DEFxxxx.DAT
  85.    files will be taken from the CURRENT directory - ie. the top window if this
  86.    option is set (or the applications directory, otherwise).
  87.  
  88.    This does  NOT start a  GEM based version,  and may well corrupt the screen
  89.    if running under MultiTOS if not installed as a TOS application.
  90.  
  91. 2) Enter the filename on the command line.This is very similar to the previous
  92.    method. Once again,  this is not  a GEM based  method, and is  suitable for
  93.    running from a command shell (eg BASH/KSH/CSH under MiNT).
  94.  
  95. 3) Double  click on  the program icon. This will  start up  the program  as it
  96.    would any other.  A GEM based  shell is provided,  which eases  use of  the
  97.    program.  Note that  it will be  difficult (if not  impossible) to use this
  98.    method in a resolution with < 640 pixels horizontally.
  99.  
  100.    Simply select 'Fix' to fix a STOS file - select the file to be fixed in the
  101.    file selector, and let the fixer do its stuff.
  102.  
  103.    On selecting the 'OS Versions' button, the dialog will change to enable you
  104.    to  select  which  OS  versions will  be used  when fixing programs in this
  105.    session - note that this info is not stored, and so you  may need to set it
  106.    every time. The scrolling list on the left contains the names of all of the
  107.    DEFxxxx.DAT files that were  found. Those that  are highlighted (ie. black)
  108.    will be used when patching.  The 'default'  file is the one  that STOS will
  109.    use if the OS version found is not one of those given  in the table. To set
  110.    the default, simply click  on the arrow  pointing right. This  will set the
  111.    default to the version imediately next to the arrow.
  112.  
  113.  
  114.  
  115.  
  116. Limitations.
  117. ------------
  118.  
  119. This program will not  necessarily fix a program  which has already been fixed
  120. by either this fixer, or either of the other two fixers available - always fix
  121. straight after compilation to solve problems of this kind.
  122.  
  123. Also, programs which have been packed will not be fixable - use NewDepack from
  124. Sinister Developments to decompress the program. (this program is no longer in
  125. development as SD. have left the Atari scene. However, Mike Watson of Sinister
  126. Developments is  prepaired to  try and  answer any  questions via email at the
  127. address: mike@sindev.co.uk)
  128.  
  129. Programs which use extensions may still not work after being fixed - check the
  130. Falcon compatibility section below for more details.
  131.  
  132. I cannot garauntee that all programs can be fixed. However, if after fixing it
  133. successfully  works on your  machine, it probably works  under all OS versions
  134. that you have specified. If STOS Fix 3 by R.Quezada does not fix a program, it
  135. is highly unlikely that this program will have any more luck.
  136.  
  137.  
  138.  
  139.  
  140. Falcon Compatibility.
  141. ---------------------
  142.  
  143. The Falcon has a number of major changes  from the ST -  this causes  programs
  144. which have been writen  without considering  these changes  likely to  cause a
  145. crash.  However,  it is  possible to  write a  program in STOS  that will work
  146. without problems on the Falcon.
  147.  
  148. The things to consider with regard to the Falcon are:
  149.  
  150. 1) Dont pack your program with the 'Atomic Packer' as this crashes the Falcon.
  151.    - use  PACK ICE  instead.  (Interesting note:  in Top Notch's  Missing Link
  152.    Extension  documention they say that the Falcon is very  compatible - guess
  153.    which packer they used to pack the install program!)
  154.  
  155. 2) Run the  Falcon with a clean  setup - hold down control while booting. This
  156.    will start the Falcon in ST-Low  resolution, with  no desk accessories/auto
  157.    boot programs but with the hard-drive active. Holding down 'Alternate' will
  158.    also disable the hard-drive.
  159.  
  160. 3) Rename your program from PRG to TOS - This will cause the graphics commands
  161.    to work better. Always do this as there is no advantage to being a PRG file
  162.    (unless  its a  GEM  program, which  is currently  impossible  for  a  STOS
  163.    program). 
  164.  
  165. 4) When using extensions, try and use Falcon tested commands -  some extension
  166.    authors have done some nasty things which  crash the Falcon. The  following
  167.    extensions have been tested on the Falcon, and work without problems:
  168.  
  169.      Maestro, Control, Extra, Ninja Tracker, Falcon (obviously), Compact,
  170.      Blitter and Compiler.
  171.  
  172.    The Missing Link works, although a couple of commands do not  - namely  the
  173.    music/sample playing routines.
  174.  
  175.    The STE Extension, and any other STE extension probably work on the Falcon,
  176.    although there are slight differences in the way hardware  scrolling works,
  177.    and also  the lowest frequency  provided on the STE DMA  hardware (8khz) is
  178.    not valid, and will not generate any sound.
  179.  
  180.    The  following extensions  do  NOT  work on  the Falcon,  and so  should be
  181.    avoided.
  182.  
  183.      STOS Tracker (the one that uses .ABK files).
  184.  
  185. If at  all  possible you  should try  and get  your STOS programs  tested on a
  186. Falcon before releasing it. However, if you cannot it is still worth doing the
  187. above so that you have a higher chance of it working correctly.
  188.  
  189.  
  190.  
  191. Known bugs:
  192. -----------
  193.  
  194. Sometimes there are minor  redraw bugs, with  the window  slightly too  small.
  195. This mainly occurs after an UN-Iconify (under AES 4.1).
  196.  
  197. There may  or may  not be window  bugs on ST's.  This is  because my  windowed
  198. dialogue routine assumes the width of the window bar is 16pixels. This may not
  199. be the case on older OS versions - but I dont have an ST handy to test this.
  200.  
  201. The entire program is  loaded into memory - thus  making it  difficult to  fix
  202. BIG programs on a 520 (or maybe  even 1040). [Thats fine with me - I have 4mb,
  203. and may soon have more! :-)]
  204.  
  205. If you  find a bug, then don't hesitate to contact me (Anthony Jacques) at the
  206. address below...
  207.  
  208.  
  209. Legal stuff:
  210. ------------
  211.  
  212. This program is released as FREEWARE. As such, this program may be distributed
  213. in any form (PD libaries, electronic  file transfer, coverdisks etc.)  so long
  214. as none of the files enclosed are modified, or omitted. 
  215.  
  216. Also, there is no waranty that this program will  work - explicit or  implied.
  217. This program directly modifies  program files - thus  there is a potential for
  218. programs to  be damaged - you  fix  programs  AT  YOUR  OWN  RISK.  Always run
  219. this program on a backup.
  220.  
  221. Although this program is Freeware,  any donations  are welcome,  and would  be
  222. greatfully recieved. :-) 
  223.  
  224.  
  225.  
  226. Credits:
  227. --------
  228.  
  229. Original fixer code:    Les Greenhalgh
  230.           (in STOS)
  231.  
  232. C implementation:       Anthony Jacques
  233.  
  234. DEFxxxx.DAT files
  235.        created by:      STOS Fix 3, by Robert Quezada
  236.  
  237. Thanks to everyone who sent me the DEFxxxx.DAT files so that I  could build up
  238. a complete collection... (excluding TT Tos).
  239.  
  240.  
  241.  
  242. Contact info:
  243. -------------
  244.  
  245. Anthony Jacques:
  246.  
  247.       70 West Avenue,
  248.       Oldfield Park
  249.       Bath
  250.       Avon  BA2 3QD
  251.       England
  252.  
  253.   term-time 95/96:  
  254.       25 Balleratt Street
  255.       Levenshulme
  256.       Manchester
  257.       England
  258.  
  259.   email: jacquesa@cs.man.ac.uk
  260.   WWW:   http://www.cs.man.ac.uk/~jacquesa/
  261.  
  262. Les Greenhalgh:
  263.       24 Park Avenue
  264.       Rudloe Manor
  265.       Corsham
  266.       Wiltshire
  267.       SN13 0JT
  268.       England
  269.  
  270. Robert Quezada:
  271.  
  272.    I have no contact address for Robert - the email address in his
  273.    STOS Fix 3 documentation is no longer valid.
  274.  
  275.  
  276.  
  277. Well, thats about all you need to know....
  278.  
  279. Anthony Jacques, 11/2/96
  280.  
  281.  
  282. 8<- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  283.  
  284.  
  285. Advertisements....
  286.  
  287.  
  288. STOS Falcon Extension v1.3 - shareware (5 pounds registration)
  289.  
  290.   +  true colour sprite routines - now including Tempest 2000 style
  291.      fragment, and a real-time sprite scaling engine.
  292.   +  DSP playback of 4-32 channel modules at 50khz 16-bit stereo.
  293.   +  full access to the sound system (including dsp processing).
  294.   +  4 to 65536 colour graphics routines.
  295.   +  Playback of FLI and FLC animations in truecolour.
  296.  
  297. For more information, contact:
  298.  
  299. Anthony Jacques, 70 West Avenue, Oldfield Park, Bath. BA2 3QD
  300. http://www.cs.man.ac.uk/~jacquesa/  or  jacquesa@cs.man.ac.uk
  301.  
  302.  
  303.  
  304. STOS Mailing list.
  305.  
  306. Are you a STOS user who is online? Well, if you have internet access, then you
  307. can join the STOS mailing list and take part in STOS discussions/ask questions
  308. to some  of the  best STOS  programmers  around -  Tony Greenwood  of  STOSSER
  309. Software, Martin Cubitt author of the Extra Extension, ()rm of Digi Tallis and
  310. Anthony Jacques  author of the STOS Falcon Extension, as well as many others.
  311.  
  312. For more information, email: jacquesa@cs.man.ac.uk
  313.  
  314. To subscribe send a mail to: stos-request@man.ac.uk with the word subscribe in
  315. the body of the email.
  316.  
  317.  
  318.  
  319. STOS FTP site.
  320.  
  321. The biggest FTP site on the  InterNET for STOS  software is ftp.uni-kl.de STOS
  322. stuff can be found  in the pub/Atari/programming/STOS/ directory.  If you  are
  323. using a WWW-browser such as Netscape, then the address is:-
  324. ftp://ftp.uni-kl.de/pub/Atari/programming/STOS/
  325.  
  326.  
  327.  
  328. STOSSER WWW pages.
  329.  
  330. The biggest STOS related World Wide Web pages  on the STOSSER homepage and can
  331. be found at  http://www.airtime.co.uk/stosser/  and contain links to all other
  332. STOS related pages, and has lots of information about STOS products.
  333.  
  334.  
  335.  
  336. Bad Mood.
  337.  
  338. This is an  internet project to create a Falcon  (and perhaps TT/Eagle/Medusa)
  339. version of Doom.  At the moment this is in its early stages, but it is already
  340. possible  to wander  around light-sourced,  texture-mapped  Doom,  Doom 2  and
  341. Heretic levels. This is a game which ALL Falcon owners will be interested in..
  342. It has been tested on both the BlowUP-FX card, and also on the Afterburner040.
  343.  
  344. for more information, visit: http://rand.thn.htu.se/~johan/bad_mood.html or to
  345. join the  Bad Mood mailing list, email  bad_mood@rand.thn.htu.se with the word
  346. subscribe in the subject line.
  347.  
  348. 8<- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  349.